home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr24 / dup21.zip / FMT21.DOC < prev    next >
Text File  |  1993-04-08  |  15KB  |  484 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                       F M T
  20.  
  21.  
  22.  
  23.                    Version 2.1
  24.  
  25.  
  26.  
  27.                   Documentation
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.       FMT   Copyright 1992, 1993   Chang Ping Lee   ALL RIGHTS RESERVED
  55.  
  56.  
  57.  
  58.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  1
  59.  
  60.  
  61.  
  62.                   Table Of Contents
  63.  
  64.  
  65.       Disclaimer of warranty. . . . . . . . . . . . . . . . . . . .  2
  66.  
  67.       License . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  68.  
  69.       1.   Introduction . . . . . . . . . . . . . . . . . . . . . .  4
  70.  
  71.       2.   How to install and run FMT . . . . . . . . . . . . . . .  5
  72.  
  73.       3.   Configuration file and command line arguments. . . . . .  6
  74.  
  75.       4.   Inside CONFIG.DCF. . . . . . . . . . . . . . . . . . . .  7
  76.  
  77.       5.   Command line arguments and examples. . . . . . . . . . .  8
  78.  
  79.       6.   How to assign serial numbers and labels. . . . . . . . . 10
  80.  
  81.  
  82.  
  83.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  2
  84.  
  85.  
  86.  
  87.             DISCLAIMER  OF WARRANTY
  88.  
  89.  
  90.     THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS". THE AUTHOR HEREBY
  91.     DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS
  92.     DOCUMENTATION FILE, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  93.     TO DAMAGE TO HARDWARE, SOFTWARE AND/OR DATA FROM USE OF THIS
  94.     PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE
  95.     TO YOU OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR USE OF THIS
  96.     SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE AND
  97.     OTHER TERMS INCLUDED IN THIS DOCUMENTATION FILE.
  98.  
  99.  
  100.     DUE TO THE NATURE OF EVOLVING PROGRAMMING AND THE VARIOUS
  101.     HARDWARE AND SOFTWARE ENVIRONMENTS IN WHICH THIS SOFTWARE MAY
  102.     BE USED, IT IS UNDERSTOOD THAT OCCASIONAL "BUGS" OR UNFITNESS
  103.     MAY ARISE. THE USER SHOULD ALWAYS TEST THIS SOFTWARE THOROUGHLY
  104.     WITH NON-CRITICAL DATA BEFORE RELYING ON IT.
  105.  
  106.  
  107.  
  108.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  3
  109.  
  110.  
  111.  
  112.                 LICENSE
  113.  
  114.  
  115.     1. In return for the payment of a one time fee, the customer is
  116.     granted a non-commercial or commercial license.
  117.  
  118.     2. If the registration is for a non-commercial license the customer
  119.     can use the software for personal backup or other usages in which
  120.     the customer make no profit and the duplicated diskettes of any
  121.     particular source diskette (or image file) are not distributed to
  122.     more than ten persons. In addition, the software may not be used in
  123.     any business, organization, institution or government agency.
  124.  
  125.     3. If the registration is for a commercial license the customer can
  126.     use the software in a business, organization, institution or
  127.     government agency, for profit or non-profit purposes. With a
  128.     commercial license the customer can distributed the duplicated
  129.     diskettes to as many persons as he or she likes
  130.  
  131.     4. The customer may use the product just-like-a-book which means
  132.     this software can be used by more than one person and can be moved
  133.     from one computer to another so long as there is NO POSSIBILITY of
  134.     it being used by two different persons on two different computers
  135.     at the same time, just like a book can not be read by two different
  136.     persons in two different places at the same time.
  137.  
  138.     5. This software and its documentation and all supplemental files
  139.     are property of the author and may not be duplicated for sale to
  140.     any third parties without written permission from the author.
  141.  
  142.     6. The customer agrees that this product is protected by United
  143.     States copyright law and international copyright treaty provisions.
  144.     Purchase of this license does not transfer any right, title or
  145.     interest in the product to the customer except as specifically set
  146.     forth in this license agreement.
  147.  
  148.     7. The author of this software product reserves the right to
  149.     terminate this license upon breach.
  150.  
  151.  
  152.  
  153.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  4
  154.  
  155.  
  156.  
  157.     1. INTRODUCTION:
  158.  
  159.  
  160.        FMT is a utility to format 360KB, 1.2MB, 720KB and 1.44MB
  161.        diskettes. Features include no keyboard operation, serial
  162.        number and label assignment and bad sectors handling.
  163.  
  164.  
  165.        The serial number and label can be assigned incrementally with
  166.        a text file which stores the serial number and label for the
  167.        next diskette to be formatted. You can keep more than one text
  168.        file for this purpose. Before exit, FMT will update the file
  169.        automatically.
  170.  
  171.  
  172.        Conventionally, a cluster is marked as bad cluster if the
  173.        formatting program fails to access after three tries. FMT,
  174.        however, adopts a more strict policy to ensure that your
  175.        valuable data won't be saved on places which are bad or about to
  176.        turn bad. FMT will try three times too. The difference is that
  177.        if FMT fails to access a sector in the first try it will mark
  178.        the sector bad and tell you how many tries has failed.
  179.  
  180.  
  181.  
  182.  
  183.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  5
  184.  
  185.  
  186.  
  187.     2. HOW TO INSTALL AND RUN FMT
  188.  
  189.  
  190.        Copy the EXE and DOC files to a directory created for DCF and
  191.        DUP. Define the PATH in your AUTOEXEC.BAT to include the
  192.        directory of FMT.EXE or the directory of a one-line batch file
  193.        which contains the path of FMT.EXE.
  194.  
  195.  
  196.        Type "FMT" followed by the "enter" key to execute the program.
  197.        The first time you run the program it will ask for a formatted
  198.        diskette so that it can create a FMT.DAT file.
  199.  
  200.  
  201.        After the FMT.DAT file has been created, you can start
  202.        formatting diskettes. You can specify the floppy drive on the
  203.        command line.
  204.  
  205.  
  206.        If you only have one or two floppy drives you can skip the rest
  207.        of this section.
  208.  
  209.  
  210.        In systems with four floppy drives, if a device driver which
  211.        came with the controller is installed FMT usually can detect the
  212.        drive letters automatically and the drive letters should be used
  213.        to specify the third and fourth drives. If no device driver
  214.        (TSR) is installed you need to use 3 and 4 as the drive letters
  215.        for the third and fourth drives. In this case you need to edit a
  216.        text file, CONFIG.DCF, that provides the information on floppy
  217.        drive capacity.
  218.  
  219.  
  220.        The following is an example of the text file in which a 1.2MB,
  221.        a 1.44MB and a 360KB drives are specified as the first, the
  222.        second and the third drives with drive letters A: B: and G:,
  223.        respectively. The 0 on the last line indicates that the fourth
  224.        drive is not installed. If all drives are defined, such as in
  225.        the example, FMT will not check with DOS for drive capacity.
  226.        This can speed up the initialization process.
  227.  
  228.        $DRIVE
  229.         1 1200 A:
  230.         2 1440 B:
  231.         3  360 G:
  232.         4    0
  233.  
  234.  
  235.  
  236.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  6
  237.  
  238.  
  239.  
  240.     3. CONFIGURATION FILE AND COMMAND LINE ARGUMENTS
  241.  
  242.  
  243.        If you have read the DOC file of DCF you can skip this section
  244.        and continue at section 5.
  245.  
  246.  
  247.        Basically, configuration file is used to stored information
  248.        which you don't expect to change often while command line
  249.        arguments are used for specifying more dynamic parameters.
  250.  
  251.  
  252.        For example, it's unlikely that you need to change the drive
  253.        capacity often, so these information can only be specified in
  254.        the configuration file, not on the command line.
  255.  
  256.  
  257.        On the other hand, it's unlikely that you use the same source
  258.        and target each time, so these can only be specified on the
  259.        command line, not in the configuration file.
  260.  
  261.  
  262.        The only information you can specified both in the configuration
  263.        file and command line is the default options. You may have your
  264.        own idea how the defaults should be (in configuration file) and
  265.        make a slight adjustment (on command line) when necessary. In
  266.        other words, command line options override the configuration
  267.        file options.
  268.  
  269.  
  270.        The configuration file is a text file. The default file name is
  271.        CONFIG.DCF. If you use the default file name you can simply type
  272.        "FMT" at DOS prompt and the program will retrieve information
  273.        from the file automatically.
  274.  
  275.  
  276.        There are cases that you need to use a different name. For
  277.        example, you may want to keep two configuration files for
  278.        different applications. In this case you need to provide the
  279.        file name on the command line. For example, if file ABC is your
  280.        configuration file you need to type "FMT @ABC" at DOS prompt.
  281.  
  282.  
  283.        The usage of the configuration file is explained in the next
  284.        section. The usage of command line arguments is fully explained
  285.        in section 5.
  286.  
  287.  
  288.  
  289.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  7
  290.  
  291.  
  292.  
  293.     4. INSIDE CONFIG.DCF
  294.  
  295.  
  296.        If you have read the DOC file of DCF you can skip this section
  297.        and continue at section 5.
  298.  
  299.  
  300.        The user can specify up to seven keywords in the configuration
  301.        file. Each keyword specify a specific kind of parameters or
  302.        information.
  303.  
  304.  
  305.        $DRIVE : You don't need to provide this information except for
  306.             the following two cases. If the program fails to get
  307.             the correct drive capacity from your system or if you
  308.             want to access four drives without installing the
  309.             device driver which came with the controller you can
  310.             use this keyword to specify the drive capacity in the
  311.             CONFIG.DCF file.
  312.  
  313.             The next few lines contain parameters about diskette
  314.             drives in your system. On each line, the first number
  315.             specify the drive, 1 for drive A:, 2 for drive B:, 3
  316.             and 4 for third and fourth drives in a four drive
  317.             system. The second number is the drive capacity in KB.
  318.             A drive letter (optional) can be specified at the end.
  319.             See section 4 of DCF40F.DOC for details.
  320.  
  321.  
  322.        $OPTION : The next few lines specify the default options used by
  323.              FMT at start up. The format is the same as those on
  324.              the command line but without the leading /. See
  325.              section 5 for details.
  326.  
  327.  
  328.        $SYSPATH : The next line specifies the path for system file.
  329.               For example, FMT.DAT is considered a system file.
  330.  
  331.  
  332.        $IMGPATH : Not used by FMT.
  333.  
  334.  
  335.        $TMPPATH : Not used by FMT.
  336.  
  337.  
  338.        $NOMSG : Not used by FMT.
  339.  
  340.  
  341.  
  342.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  8
  343.  
  344.  
  345.  
  346.     5. COMMAND LINE ARGUMENTS AND EXAMPLES
  347.  
  348.  
  349.        If you have read the DOC file of DCF you only need to learn the
  350.        t option.
  351.  
  352.  
  353.        There are fourteen options you can specify using command line
  354.        arguments. You can also specify these options in the CONFIG.DCF
  355.        file. The command line options override the CONFIG.DCF options.
  356.  
  357.  
  358.        In addition, you can also specify an alternative configuration
  359.        file and the text file for serial number and label on the command
  360.        line. See examples at the end of this section.
  361.  
  362.  
  363.        Note that the '+' sign after any option can be omitted.
  364.  
  365.  
  366.        /c  followed by +/-. Set Compare ON/OFF. When ON the program
  367.            performs read-back and byte-by-byte comparison for every
  368.            track formatted on a target diskette.  Default is ON.
  369.  
  370.        /m  Not used by FMT.
  371.  
  372.        /f  Not used by FMT.
  373.  
  374.        /s  followed by +/-. Set Sound ON/OFF. When ON the program will
  375.            give an audio signal after formatting a diskette or 20
  376.            seconds of inactivity. Default is ON.
  377.  
  378.        /q  Not used by FMT.
  379.  
  380.        /k  Not used by FMT.
  381.  
  382.        /n  Not used by FMT.
  383.  
  384.        /d  Not used by FMT.
  385.  
  386.        /t  followed by +/-. Set target density. In DCF, this option is
  387.            used for source density. In FMT, however, it is used for
  388.            specifying target density. If + the program creates high
  389.            density diskette in a 1.2 or 1.44MB drive. If - it creates
  390.            low density diskette instead. No default is assumed.
  391.  
  392.  
  393.  
  394.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page  9
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.        /o  followed by +/-. Set "mono in color" mode. In a color
  402.            system, you can use /o+ to force FMT run in black and white.
  403.            Default is -.
  404.  
  405.        /x  Not used by FMT.
  406.  
  407.        /b  Not used by FMT.
  408.  
  409.        /a  Not used by FMT.
  410.  
  411.        /w  Not used by FMT.
  412.  
  413.        @file_name  specify alternative name for the configuration file.
  414.  
  415.        #file_name  specify a text file containing information for
  416.                serial number and label assignment.
  417.  
  418.        drive:  define a floppy drive for formatting.
  419.  
  420.  
  421.        EXAMPLES:
  422.  
  423.  
  424.        FMT /t+c-s-    Set defaults of target Density, Compare and Sound
  425.               to HIGH, OFF and OFF.
  426.  
  427.        FMT /tc-s-     Same as the last example. The '+' can be and is
  428.               omitted.
  429.  
  430.        FMT A:         Format with drive A:.
  431.  
  432.        FMT 3:         Format with the third drive, when device driver
  433.               is not installed.
  434.  
  435.        FMT G:         Same as the last example, but in this case the
  436.               driver is installed and the drive letters is G.
  437.  
  438.  
  439.  
  440.       FMT   Copyright 1992, 1993   Chang Ping Lee                   page 10
  441.  
  442.  
  443.  
  444.     6. HOW TO ASSIGN SERIAL NUMBERS AND LABELS
  445.  
  446.  
  447.        You need to create a text file which stores the serial number
  448.        and label for the next diskette to be copied. You can also use
  449.        more than one file, for example, file F360 for 360KB diskettes,
  450.        F720 for 720 KB diskettes, etc.
  451.  
  452.        FMT looks for file VOLUME.FMT automatically, so if you create a
  453.        file called VOLUME.FMT for this purpose you don't need to
  454.        specify the file name on the command line. Otherwise, you'll
  455.        need to use a command line argument. For example, if you type
  456.        "FMT #SERIAL" FMT will look for the file SERIAL for serial
  457.        number and label information.
  458.  
  459.        The following is an example of the text file.
  460.  
  461.        $SERIAL
  462.         2F3D1355
  463.        $LABEL
  464.         DISK_*****
  465.         32
  466.  
  467.        The keyword $SERIAL indicates that serial number will follow on
  468.        the next line. Similarly, The keyword $LABEL indicates the label
  469.        will follow on the next line. The label can contain a number
  470.        which is to be increased on each diskette being formatted. To
  471.        imbed a number in the label use *'s to indicate where you want
  472.        the number to be and then on the following line specify the
  473.        number to be imbedded. FMT only takes one string for label. If
  474.        you need spaces use underscores. The above example will produce
  475.        a diskette with label "DISK    32", the underscore replaced by
  476.        space, the stars replaced by the number. If you quit, say after
  477.        formatting five diskette, the file will be updated and the
  478.        number 32 will be changed to 37. The serial number will be
  479.        updated too.
  480.  
  481.        Note that the serial number is hexadecimal while the number
  482.        imbedded in the label is decimal.
  483.  
  484.